IRIX Base Documentation 2001 May/SGI IRIX Base Documentation 2001 May.iso/usr/share/catman/g_man/cat3/OpenGL/glubuild3dmipmaplevels.z/glubuild3dmipmaplevels

Text File | 2001-04-17 | 22.7 KB | 199 lines

gggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     gggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))



NNNNAAAAMMMMEEEE
     gggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss - builds a subset of three-dimensional mipmap
     levels


CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
     GLint gggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss( GLenum _t_a_r_g_e_t,
                                   GLint _i_n_t_e_r_n_a_l_F_o_r_m_a_t,
                                   GLsizei _w_i_d_t_h,
                                   GLsizei _h_e_i_g_h_t,
                                   GLsizei _d_e_p_t_h,
                                   GLenum _f_o_r_m_a_t,
                                   GLenum _t_y_p_e,
                                   GLint _l_e_v_e_l,
                                   GLint _b_a_s_e,
                                   GLint _m_a_x,
                                   const void *_d_a_t_a )


PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
     _t_a_r_g_e_t          Specifies the target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD.

     _i_n_t_e_r_n_a_l_F_o_r_m_a_t  Requests the internal storage format of the texture
                     image.  Must be 1, 2, 3, 4, or one of the following
                     symbolic constants:  GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____AAAALLLLPPPPHHHHAAAA8888,
                     GGGGLLLL____AAAALLLLPPPPHHHHAAAA11112222, GGGGLLLL____AAAALLLLPPPPHHHHAAAA11116666, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____AAAALLLLPPPPHHHHAAAA4444,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE6666____AAAALLLLPPPPHHHHAAAA2222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____AAAALLLLPPPPHHHHAAAA8888,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA11112222,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____AAAALLLLPPPPHHHHAAAA11116666, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY4444,
                     GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY8888, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11112222, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11116666, GGGGLLLL____RRRRGGGGBBBB,
                     GGGGLLLL____RRRR3333____GGGG3333____BBBB2222, GGGGLLLL____RRRRGGGGBBBB4444, GGGGLLLL____RRRRGGGGBBBB5555, GGGGLLLL____RRRRGGGGBBBB8888, GGGGLLLL____RRRRGGGGBBBB11110000,
                     GGGGLLLL____RRRRGGGGBBBB11112222, GGGGLLLL____RRRRGGGGBBBB11116666, GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____RRRRGGGGBBBBAAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA4444,
                     GGGGLLLL____RRRRGGGGBBBB5555____AAAA1111, GGGGLLLL____RRRRGGGGBBBBAAAA8888, GGGGLLLL____RRRRGGGGBBBB11110000____AAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA11112222, or
                     GGGGLLLL____RRRRGGGGBBBBAAAA11116666.

     _w_i_d_t_h, _h_e_i_g_h_t, _d_e_p_t_h
                     Specifies in pixels the width, height and depth
                     respectively, of the texture image. These should be a
                     power of 2.

     _f_o_r_m_a_t          Specifies the format of the pixel data.  Must be one of
                     GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX, GGGGLLLL____DDDDEEEEPPPPTTTTHHHH____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT, GGGGLLLL____RRRREEEEDDDD, GGGGLLLL____GGGGRRRREEEEEEEENNNN,
                     GGGGLLLL____BBBBLLLLUUUUEEEE, GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____RRRRGGGGBBBB, GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____BBBBGGGGRRRR, GGGGLLLL____BBBBGGGGRRRRAAAA,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, or GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA.

     _t_y_p_e            Specifies the data type for _d_a_t_a.  Must be one of
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____BBBBYYYYTTTTEEEE, GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT,
                     GGGGLLLL____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT, GGGGLLLL____IIIINNNNTTTT, GGGGLLLL____FFFFLLLLOOOOAAAATTTT,
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV,
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV,



                                                                        PPPPaaaaggggeeee 1111






gggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     gggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))



                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV,
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV,
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV,
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, or
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV.

     _l_e_v_e_l           Specifies the mipmap level of the image data.

     _b_a_s_e            Specifies the minimum mipmap level to pass to
                     ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD.

     _m_a_x             Specifies the maximum mipmap level to pass to
                     ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD.

     _d_a_t_a            Specifies a pointer to the image data in memory.

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     gggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss builds a subset of prefiltered three-dimensional
     texture maps of decreasing resolutions called a mipmap. This is used for
     the antialiasing of texture mapped primitives.

     A return value of zero indicates success, otherwise a GLU error code is
     returned (see gggglllluuuuEEEErrrrrrrroooorrrrSSSSttttrrrriiiinnnngggg).

     A series of mipmap levels from _b_a_s_e to _m_a_x is built by decimating _d_a_t_a in
     half along both dimensions until size 1 x 1 x 1 is reached. At each
     level, each texel in the halved mipmap level is an average of the
     corresponding eight texels in the larger mipmap level. (If exactly one of
     the dimensions is 1, four texels are averaged.  If exactly two of the
     dimensions are 1, two texels are averaged.)  ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD is called to
     load these mipmap levels from _b_a_s_e to _m_a_x. If _m_a_x is larger than the
     highest mipmap level for the texture of the specified size, then a GLU
     error code is returned (see gggglllluuuuEEEErrrrrrrroooorrrrSSSSttttrrrriiiinnnngggg) and nothing is loaded.

     For example, if _l_e_v_e_l is 2 and _w_i_d_t_h is 16, _h_e_i_g_h_t is 8 and _d_e_p_t_h is 4,
     the following levels are possible: 16 x 8 x 4, 8 x 4 x 2, 4 x 2 x 1,
     2 x 1 x 1, 1 x 1 x 1.  These correspond to levels 2 through 6
     respectively.  If _b_a_s_e is 3 and _m_a_x is 5, then only mipmap levels
     8 x 4 x 2, 4 x 2 x 1 and 2 x 1 x 1 are loaded. However, if _m_a_x is 7 then
     an error is returned and nothing is loaded, since _m_a_x is larger than the
     highest mipmap level which is, in this case, 6.

     The highest mipmap level can be derived from the formula
     log(max(width,height,depth)2level).

     See the ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD reference page for a description of the acceptable
     values for _f_o_r_m_a_t parameter. See the ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss reference page for a
     description of the acceptable values for _t_y_p_e parameter.







                                                                        PPPPaaaaggggeeee 2222






gggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     gggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))



NOTES
     gggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss is only available if the GLU version is 1.3 or
     greater.

     Formats GGGGLLLL____BBBBGGGGRRRR, and GGGGLLLL____BBBBGGGGRRRRAAAA, and types GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222,
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555,
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444,
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111,
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888,
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, and
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV are only available if the GL version is
     1.2 or greater.

EEEERRRRRRRROOOORRRRSSSS
     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is returned if _l_e_v_e_l > _b_a_s_e, _b_a_s_e < 0, _m_a_x < _b_a_s_e or
     _m_a_x is > the highest mipmap level for _d_a_t_a.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is returned if _w_i_d_t_h, _h_e_i_g_h_t, or _d_e_p_t_h is < 1.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is returned if _i_n_t_e_r_n_a_l_F_o_r_m_a_t, _f_o_r_m_a_t, or _t_y_p_e is not
     legal.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222 or
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV and _f_o_r_m_a_t is not GGGGLLLL____RRRRGGGGBBBB.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555 or
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV and _f_o_r_m_a_t is not GGGGLLLL____RRRRGGGGBBBB.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444 or
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV and _f_o_r_m_a_t is neither GGGGLLLL____RRRRGGGGBBBBAAAA nor GGGGLLLL____BBBBGGGGRRRRAAAA.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111 or
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV and _f_o_r_m_a_t is neither GGGGLLLL____RRRRGGGGBBBBAAAA nor GGGGLLLL____BBBBGGGGRRRRAAAA.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888 or
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV and _f_o_r_m_a_t is neither GGGGLLLL____RRRRGGGGBBBBAAAA nor GGGGLLLL____BBBBGGGGRRRRAAAA.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222
     or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV and _f_o_r_m_a_t is neither GGGGLLLL____RRRRGGGGBBBBAAAA nor
     GGGGLLLL____BBBBGGGGRRRRAAAA.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD,
     gggglllluuuuBBBBuuuuiiiilllldddd1111DDDDMMMMiiiippppmmmmaaaappppssss, gggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppssss, gggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppssss, gggglllluuuuEEEErrrrrrrroooorrrrSSSSttttrrrriiiinnnngggg,
     ggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee, ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr, gggglllluuuuBBBBuuuuiiiilllldddd1111DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss,
     gggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss









                                                                        PPPPaaaaggggeeee 3333